home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mailmsg3.zip / README.1ST < prev   
Text File  |  1993-01-29  |  8KB  |  184 lines
  1. Mail reminder script (Ver 3.0) & screen saver for ICOM (Ver 1.0)
  2. by John LeaverPower, Jan'93
  3.  
  4.  
  5. PURPOSE
  6. *******
  7. Have you ever come back to your PC and wished Icom would let you know
  8. immediately if you have any personal mail in that last downloaded QWK
  9. packet?  Or, have you ever missed getting some mail because it was sent
  10. to you from a conference which was NOT on your offline reader's "active"
  11. conference list?  Or, do you run several different Icom jobs, and don't
  12. want to do a "mail run" until you know you have some personal mail
  13. waiting?
  14.  
  15. If so, this program may be of assistance.  It captures all your
  16. "mail reminders" at logon and appends them to a file, MAILWARN.TXT in
  17. your capture directory.  You can then browse this file at your
  18. convenience and check for Conference titles which are not currently on
  19. your "Joined" list.  My thanks to Eric Decker for suggesting this
  20. add-on.
  21.  
  22. It can also check your default capture file at the end of an Icom
  23. session to see if you have received any personal mail in the QWK
  24. packet(s) you just downloaded.
  25.  
  26. This zip file comes with an optional screen saver.  If either of the
  27. above 2 conditions are met, the program can run a screen saver with
  28. a moving "Personal Mail Waiting" text box.  The screen saver can be
  29. configured to a) run until you stop it manually, b) run for a set
  30. period (countdown timer), or c) run until a specific time of the day.
  31.  
  32.  
  33. UPDATE (from Ver 2)
  34. *******************
  35. Although the screen saver exe file remains the same as in Ver 2, the
  36. rest of the program has been completely revamped:
  37.         1) The Mailwarn.txt file produced by ver 2 often contained
  38.            several extra "BBS name" lines, and if multiple BBS's each
  39.            contained new mail notices at logon, the conference titles
  40.            would sometimes be placed at the end of Mailwarn.txt
  41.            instead of beneath the appropriate BBS names.  These
  42.            problems have been fixed by using a different technique and
  43.            an additional utility.
  44.         2) The latest version of the utility fgrep.com is included
  45.            with this package.
  46.         3) The script file now includes explanatory comments.
  47.         4) With Ver 3.0, the script now passes the name of the Icom cap
  48.            file to the main batch file Mailwarn.bat.  This will allow
  49.            those with multiple capture file names to easily customize
  50.            the script to suit their needs.  The default cap file is
  51.            ICOM.CAP.
  52.  
  53.  
  54. SETUP
  55. *****
  56. If you are upgrading from Mailmsg2.zip (Ver 2.0), please follow the
  57. instructions below.  This will ensure the old files are over-written
  58. with the new versions.
  59.  
  60. To upgrade from Mailmsg2.zip, or for new installations, follow these
  61. steps:
  62.  
  63. 1) Place the files in the following directories on your hard disk:
  64.  
  65.                    Default                 Default
  66.    File            Location                Directory
  67.    ====            ========                =========
  68.    MAILWARN.SCR    C:\ICOM\SCR             Icom scripts
  69.    MAILWARN.BAT    C:\ICOM                 Location of ICOM.EXE
  70.    FGREP.COM       C:\ICOM\CAP             Capture files
  71.    CUT.EXE         C:\ICOM\CAP             Capture files
  72.    MAILMSG.EXE     C:\ICOM                 Location of ICOM.EXE
  73.  
  74.    If your directory locations are different from the above, edit the
  75.    MAILWARN.BAT file accordingly.
  76.  
  77.    If you have multiple cap files, edit MAILWARN.SCR to suit your
  78.    needs.  If you only use ICOM.CAP, don't make any changes to
  79.    Mailwarn.scr.
  80.  
  81. 2) Next, modify POSTJOB.BAT, in your Icom directory, to include the
  82.    following lines:
  83.  
  84.         if not exist C:\ICOM\CAP\MAILFLAG.TMP goto done
  85.         del C:\ICOM\CAP\MAILFLAG.TMP
  86.         c:\icom\mailmsg                          [see below for options]
  87.         cls
  88.         :done
  89.  
  90.    If you don't have a Postjob.bat file in your Icom directory, I have
  91.    included in this package a sample file that came with Icom, and which
  92.    has the above lines added.
  93.  
  94.    MAILFLAG.TMP is created by Mailwarn.bat if you have received personal
  95.    mail in a QWK packet or if personal mail notices were sent by PCBoard
  96.    at logon.  The screen saver is MAILMSG.EXE, and can be used in one of
  97.    these 3 formats:
  98.  
  99.         mailmsg                 <----- Runs until you stop it manually
  100.                                        using Ctrl-Break
  101.  
  102.         mailmsg hh:mm           <----- Starts a countdown timer of hh
  103.                                        hours and mm minutes, and stops
  104.                                        automatically when the timer
  105.                                        reaches 0.
  106.                                        hh must be between 00 and 23
  107.                                        mm must be between 00 and 59
  108.  
  109.         mailmsg hh:mm am        <----- Runs until the system time on
  110.         mailmsg hh:mm pm        <----- your PC reaches this time.
  111.                                        hh must be between 00 and 12
  112.                                        mm must be between 00 and 59
  113.  
  114.    The screen saver can be stopped manually at any time by using the
  115.    Ctrl-Break key combination. (Unfortunately, the utility used to
  116.    create Mailmsg.exe is limited to this key combination only.)
  117.  
  118. Although any of the 3 formats are possible, using mailmsg without any
  119. time parameters will cause the screen saver to run indefinitely, thereby
  120. tying up your PC until you manually intervene. (That may not be your
  121. intention if you have a daily mail run and you leave for, say 2 weeks
  122. vacation!).
  123.  
  124.  
  125. 3) Just a quick note on Icom's "post" bat files.  As explained below,
  126.    you can set the Mailwarn script to check for logon mail notices,
  127.    QWK packet(s), or both.  If you wish to check ONLY your QWK packets,
  128.    then the instructions in step 2 above can be in either Postmail.bat
  129.    or Postjob.bat.  If you want to check only your logon notices, or
  130.    both logon notices and QWK packets, the instructions should be in
  131.    Postjob.bat.  The reason is that Icom runs a different "post" bat
  132.    file depending on what happens during the online session.  However,
  133.    regardless of what happens online, Icom will ALWAYS run Postjob.bat.
  134.  
  135.  
  136. 4) Then, modify your Icom job(s) to add the Mailwarn script.  Here are
  137.    some examples:
  138.  
  139.         Call Canada Remote Systems      <--- Checks logon notices from
  140.            CC:@MAILWARN                      PCBoard.  MUST be the first
  141.            Send Message Replies              instruction after Call
  142.            Get All New Mail                  command to get all notices.
  143.         Exit to DOS
  144.  
  145.         Call Canada Remote Systems      <--- Checks for personal mail in
  146.            Send Message Replies              QWK packet.
  147.            Get All New Mail
  148.            CC:@MAILWARN
  149.         Exit to DOS
  150.  
  151.         Call Canada Remote Systems      <--- Checks both logon notices
  152.            CC:@MAILWARN                      and QWK packet.
  153.            Send Message Replies
  154.            Get All New Mail
  155.            CC:@MAILWARN
  156.         Exit to DOS
  157.  
  158.    Personally, I include the "@MAILWARN" script at the beginning of
  159.    every Icom job on all BBS's.  This way, any notices sent by the
  160.    board at logon will be recorded in Mailwarn.txt.  I also have the
  161.    script included after the command "Get All New Mail" in all jobs
  162.    having a "mail run".
  163.  
  164.  
  165. USAGE
  166. *****
  167. If the screen saver is active when you approach your PC, then you have
  168. some personal mail either in your QWK packet, or on the BBS.  Use
  169. Ctrl-Break to stop the screen saver.  Icom will then take over where it
  170. left off.  If you don't have any personal mail in your QWK packet, then
  171. check Mailwarn.txt for personal mail notices missed by your last QWK
  172. download.  This may happen if you have mail waiting for you in a
  173. conference you have not yet (S)elected in the online Qmail Configuration
  174. screen. It may also happen if your Icom job didn't include a "mail
  175. run" and if PCBoard sent you a "new mail waiting" message at logon.
  176.  
  177. That's it.  You may wish to clean up the MAILWARN.TXT file from time to
  178. time, for it will continuously grow as new mail reminders are added.  If
  179. you delete MAILWARN.TXT, then MAILWARN.BAT will simply create the file
  180. again as needed.
  181.  
  182. Enjoy,
  183. John.
  184.